Аудит-логи

Аудит-логи позволяют отслеживать основные события и активность сотрудников вашей организации. Это может быть полезно при инцидентах и нарушении безопасности.

С помощью аудит-логов администраторы и менеджеры аудит-логов могут посмотреть:

События в сервисах

• Как сотрудники входят в аккаунт. Например, можно увидеть когда и с какого устройства подключился сотрудник.
• Что сотрудники организации делают с письмами и файлами в Почте и Диске. Например, вы можете узнать, кто переместил письмо или файл.

События в кабинете организации

• Какие изменения вносились в кабинете организации. Например, можно узнать, кто добавил или пригласил нового пользователя.
• Что другие администраторы ищут в архиве писем и как настраивают правила для писем.

Как подключить

1. Откройте Яндекс 360 для бизнеса.
2. В меню слева выберите Аудит-логи.
3. Нажмите кнопку Подключить и подтвердите подключение.

Как посмотреть логи

Шаг 1. Укажите, какие логи нужно найти

Шаг 2. Уточните запрос с помощью фильтров

Фильтрация позволяет найти логи по заданным параметрам: например, конкретное событие за определенный период.

Чтобы добавить фильтр, нажмите на него и выберите необходимые параметры:

• Сотрудник или Администратор — Укажите одного или нескольких сотрудников и нажмите Сохранить.
• Дата — Выберите период или задайте свой.
• Событие — Укажите одно или несколько событий и нажмите Сохранить. При выборе одного события могут появиться дополнительные параметры фильтрации — можно выбрать не более трех.

Чтобы удалить фильтр, справа от него нажмите значок . Чтобы отменить выбранную фильтрацию и вернуться к предыдущему шагу, нажмите Сбросить фильтры.

Шаг 3. Соберите и просмотрите логи

1. Нажмите Найти логи.
2. Нажмите на событие в списке, чтобы узнать о нем подробнее: информация отобразится во всплывающем окне.

Если хотите посмотреть всю информацию о событии «Поиск» в архиве писем, подтвердите номер телефона, привязанный к вашему Яндекс ID. Или привяжите номер, если еще не сделали этого. Как привязать номер можно узнать в Справке Яндекс ID.

Работа с логами через API

Прежде чем начать

1. Для работы с API вам потребуется OAuth-токен, который можно получить после создания приложения в сервисе Яндекс OAuth.

   • Если у вас еще нет OAuth-приложения, то для его создания и получения токена воспользуйтесь инструкцией на странице Доступ к API. При создании приложения выберите права ya360_security:read_auditlog.
   • Если у вас уже есть OAuth-приложение для работы с API Яндекс 360 для бизнеса, то добавьте ему права доступа для чтение событий аудит-лога организации, а затем получите новый OAuth-токен по инструкции.

2. Определите идентификатор организации: откройте admin.yandex.ru и выберите Общие настройки → Профиль организации. Идентификатор будет написан под названием организации.

   

Как получить логи

1. Сформируйте GET-запрос:

   curl -X GET -H "Authorization: OAuth {oauth_token}" https://cloud-api.yandex.net/v1/auditlog/organizations/{org_id}/events?ended_at={ended_at}&count={count}
   

   В код подставьте обязательные значения:

   • {orgId} — идентификатор организации;
   • {oauth_token} — OAuth-токен;
   • {ended_at} — дата и время окончания аудит-лога в формате ISO 8601, например 2024-01-31T23:59:59;
   • {count} — количество событий на одной странице результатов от 1 до 100.

2. Чтобы уточнить запрос, укажите в конце запроса дополнительные параметры через &, например:

   &started_at={started_at}&types={types}&include_uids={include_uids}&ip={ip}&service={service}
   

   В код подставьте значения:

   • {started_at} — дата и время начала аудит-лога в формате ISO 8601, например 2024-01-01T00:00:00;
   • {types} — типы событий, которые должны быть включены в список. Можно указать несколько типов через запятую без пробела; Типы событий в документации API
   • {include_uids} — список пользователей, действия которых должны быть включены в список событий. Можно указать нескольких пользователей через запятую без пробела, например include_uids=1,2,3;
   • {ip} — IP-адрес, с которого было выполнено действие;
   • {service} — платформа, с которой поступил запрос на действие, можно указать один из списка:
     • Web – веб-сайт;
     • Desktop – программа на компьютере;
     • Mobile – мобильное приложение;
     • Api – внешний HTTP API;
     • Synchronization – внешнее приложение для автоматической синхронизации данных (например, по стандарту SCIM);
     • ID – внутренний сервис авторизации пользователей;
     • Internal – другие внутренние сервисы;
     • Unknown – источник не указан.

3. Отправьте запрос. Ответ на запрос возвращает список событий по указанным параметрам.

   Пример ответа

   {
      "iteration_key": "5",
      "items": [
        {
          "user_login": {логин},
          "user_name": {имя},
          "event": {
            "status": {статус},
            "idempotency_id": {идентификатор события},
            "uid": {идентификатор пользователя},
            "service": {сервис},
            "ip": {ip-адрес},
            "occurred_at": {дата},
            "org_id": {идентификатор организации},
            "is_system": false,
            "meta": {
              "device_id": null,
              "revision": "1"
            },
            "request_id": {идентификатор запроса},
            "type": {тип события}
          }
        }
      ]
    }
   

   Здесь:
   {логин}, {имя}, {идентификатор пользователя}, {ip-адрес} — данные инициатора события: логин и имя пользователя, идентификатор и IP-адрес;
   {статус} — результат запроса: Success (успешно) или Error (ошибка – например, в событиях авторизации, где был неправильно введен логин или пароль);
   {сервис} — платформа, с которой поступил запрос на действие, например Web – веб-сайт;
   {дата} — дата и время события;
   {тип события} — тип события, например id_cookie.set — вход через браузер. Типы событий в документации API

Документация API

Полное описание всех методов для получения аудит-логов вы найдете в документации.